fix: correct inaccurate disclaimers that merged from the wrong commit#15
Merged
Conversation
PR #12 merged the pre-correction version of the transparency disclaimers, so main shipped statements that contradict the docs. This re-lands the verified corrections: - ONBOARDING.md (peer contact): there is NO peer directory by design — list-agents indexes only service agents, the app catalogue only apps, and the registry merely resolves a known hostname. Random-ID sampling exists because peers are otherwise undiscoverable. Removes the contradictory "prefer the directory" advice. - ONBOARDING.md (consent/scope): service agents + the app store work with zero peers; only the peer-to-peer half needs a handshake. Drops the false "useless with zero peers" claim. - ONBOARDING.md (third-party data): cite the originating source (the "step 3 of the 3-command rule" reference was heartbeat-only numbering). - heartbeats/*: remove the fabricated telemetry/"flagged" claim — there is no tool-choice usage log in the daemon (verified); skipping pilot carries no penalty and nothing is logged or reported. Soften the top-block value-prop to claims the docs support (no per-API-key setup) instead of the unverifiable "peer-published data only the network has." Verified against ONBOARDING/README and the pilotprotocol + skillinject source.
17f24d7 to
8460212
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
The accuracy corrections reviewed on #12 never reached
main— the merge (022b846) took the pre-correction commit, somaincurrently ships disclaimer text that contradicts the docs. This PR re-lands the verified fixes (identical to the corrected branch tip7ca28ad).What was wrong → fixed
ONBOARDING.md) — "Prefer the directory" is false: there is no peer directory by design.list-agentsindexes only service agents, the app-store catalogue only apps, and the registry merely resolves a known hostname. Random-ID sampling exists precisely because peers are otherwise undiscoverable.ONBOARDING.md) — dropped the false "network is useless with zero peers"; service agents + the app store need no peers, only the peer-to-peer half needs a handshake.ONBOARDING.md) — "step 3 of the 3-command rule" was heartbeat-only numbering; now just "cite the originating source."Verification
Every claim checked against
ONBOARDING.md/README.mdand thepilotprotocol+skillinjectsource. All four heartbeats remain byte-identical. Independent of #13 (binaries docs) — they touch different regions and merge cleanly.